پرش به مطلب اصلی

ایجاد مکان منتخب (Post)

برای ثبت یک مکان به‌عنوان مکان منتخب استفاده می‌شود.


اطلاعات عمومی

  • آدرس: /api/v2/place
  • متد: POST
  • نوع خروجی: application/json
  • احراز هویت: نیازمند token

پارامترهای بدنه درخواست (Body)

نام پارامترنوعتوضیحات
latnumberعرض جغرافیایی مکان
lngnumberطول جغرافیایی مکان
detailed_addressstringآدرس دقیق مکان
namestringنام مکان

نمونه درخواست

curl -X POST "https://corporate.snapp.site/api/v2/place" \
-H "Authorization: <your_authorization_token>" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data-raw '{"lat":35.69978618515982,"lng":51.33777010101795,"detailed_address":"test","name":"test"}'

پاسخ موفق

{
"message": "new place stored successfully",
"data": null,
"status": 200
}

کدهای وضعیت و خطاها

کد وضعیتتوضیحات
200درخواست با موفقیت انجام شد و مکان جدید ذخیره شد
400درخواست نامعتبر است (مثلاً پارامترهای نامعتبر ارسال شده‌اند)
401عدم احراز هویت (توکن JWT نامعتبر یا منقضی‌شده است)
403دسترسی غیرمجاز
500خطای داخلی سرور